10.2.4 クラスの利用者への伝え方
あなたのクラスで何ができて何ができないかを伝えるためには、特殊メソッド__init__()にアサーション(またはその他の例外を送出するコード)を入れるのが効果的だ
コードで表現できない不変式は(そういうものはある)、利用者がAPIリファレンスとして使うものであればそれをドキュメント化しよう。
クラス内のコメントやdocstring
著者の立場:コメントでコードに人間的な側面を加える